home *** CD-ROM | disk | FTP | other *** search
/ ftp.trace.wisc.edu / ftp.trace.wisc.edu.zip / ftp.trace.wisc.edu / hearcalc.sit.hqx / HearCalc 2.0 / README < prev    next >
Text File  |  1999-07-08  |  5KB  |  84 lines

  1. HearCalc
  2. ⌐1999 Purple E Software
  3. Coded By: Erick Tejkowski
  4. Web: http://www.norcom2000.com/users/ejt/purplee.html
  5. E-mail: <ejt@norcom2000.com>
  6.  
  7. HearCalc is a nifty calculator that makes use of Apple's English Speech Recognition (⌐ Apple Computer). To use HearCalc, follow these steps:
  8.  
  9. 1. Install Apple Text-To-Speech (aka PlainTalk), Apple Speech Recognition, and Applescript.
  10.  
  11. 2. Drag all of the scripts from the "Drag To Speakable Items" folder to the "Speakable Items" folder in your Apple menu. These scripts are the phrases used to control the HearCalc calculator. You can rename these scripts, or make your own. (See below)
  12.  
  13. 3. Start Speech Recognition from the Speech control panel.
  14.  
  15. 4. Start HearCalc.
  16.  
  17. 5. Begin speaking to your Mac.
  18.  
  19.  
  20. AppleScripting
  21. HearCalc is Apple-scriptable (That's how speech recognition works!). To view the possible commands, open the HearCalc dictionary in the Script Editor. HearCalc responds to the following commands:
  22.  
  23. PressButton "zero"
  24. PressButton "one"
  25. PressButton "two"
  26. PressButton "three"
  27. PressButton "four"
  28. PressButton "five"
  29. PressButton "six"
  30. PressButton "seven"
  31. PressButton "eight"
  32. PressButton "nine"
  33. PressButton "clear"
  34. PressButton "backspace"
  35. PressButton "plus"
  36. PressButton "minus"
  37. PressButton "times"
  38. PressButton "dividedby"
  39. PressButton "equals"
  40. PressButton "point"
  41.  
  42. *** Note: the following are only available to registered users.
  43.  
  44. PressButton "sin"
  45. PressButton "cos"
  46. PressButton "tan"
  47. PressButton "asin"
  48. PressButton "acos"
  49. PressButton "atan"
  50. PressButton "square"
  51. PressButton "squareroot"
  52. PressButton "log"
  53. PressButton "memrecall"
  54. PressButton "memclear"
  55. PressButton "memstore"
  56.  
  57. Skins
  58.  
  59. 1. The appearance of HearCalc can be cutomized to suit your wishes. To use skins, you must have a folder named "Skins" (no qoutes) in the same folder as the HearCalc application. To use a skin, simply place the skin in the "Skins" folder and restart HearCalc.
  60.  
  61. 2. To make your own skin, use the included application called "HearCalc Skinmaker". With this application, you can piece together your own skin from PICT files you have made in a 3rd party graphics application. Full balloon help is included and the operation should fairly self-explanatory. Balloon help also displays the dimensions in pixels of each of the graphical parts of a skin.
  62.  
  63. 3. Unregistered users will be able to construct skins and view them in HearCalc, but after a few minutes, HearCalc returns to the default skin.
  64.  
  65. Troubleshooting
  66.  
  67. 1. - Since HearCalc utilizes Applescripts in the Speakable Items Folder, it is advisable to delete any other versions of HearCalc from your system. If you don't, the scripts may attempt to use another (and older) version of HearCalc that doesn't support a particular Applescript command. An error will result. This will be fixed in future versions.
  68.  
  69. 2. - Position your PlainTalk microphone about 6 to 8 inches from your mouth when speaking. Speak clearly at a normal speed. I have found that sitting in a quiet room is nearly essential to maximize recognition. Headset microphones avilable for the Macintosh increase recognition results significantly. (Dragon Systems used to include such a mike with their speech recognition software).
  70.  
  71. 3. - Recognition increases when fewer scripts are located in the Speakable Items Folder. Thus, it is advisable to remove any unnecessary scripts from the Speakable Items Folder.
  72.  
  73. 4. - Short filenames for the scripts located in the Speakable Items Folder decrease recognition. For example:
  74.  
  75.                                 "tangent" is less  likely to be recognized than "press the tangent button"
  76.  
  77. You can feel free to rename the scripts to anything you desire. Experimentation is key here. Speech recognition on a computer is still a monumental task. Recognition can vary wildly with volume, position of speaker, rate of speech, pitch of speech, accent, and annuciation. Be patient.  I have regularly used HearCalc with good recognition, but I follow all of the rules listed above. 
  78.  
  79. 5. SKINS - If you are having troubles with skins loading, increase the RAM allocation for HearCalc. Also, be sure that you have a folder in the same folder as HearCalc that is entitled "Skins" (no quotes). The "default" skin MUST reside here for the application to work properly. 
  80.  
  81. 6. Skinmaker - To assign "depressed" buttons to your skin, hold down the "option"-key while pressing the appropriate button in the Skinmaker. The display strip between the number and scientific function buttons and the "face" graphic do not have depressed states.
  82.  
  83. Please Report all bugs to:
  84. <ejt@norcom2000.com>